kouto swiss
A complete CSS framework for Stylus
kouto swiss is a complete CSS framework for Stylus, inspired by great tools like nib, compass, bourbon…
Installation
$ npm install --save-dev kouto-swiss
Usage
Included in compilation, with grunt or gulp.
Grunt
For grunt, you can use grunt-contrib-stylus, and include kouto swiss in your use
option for the task.
You can also use grunt-ks-stylus, which is a fork of grunt-contrib-stylus, with kouto swiss included.
Gulp
For gulp, use gulp-stylus and include kouto swiss in your use
option for the task.
PHPStorm/WebStorm File Watchers
On some IDEs like PHPStorm and Webstorm, you can automatically compile your styles as they change, without relying on a third-party tool. In PHPStorm and Webstorm, this functionality is known as file watchers. To use with PHPStorm or WebStorm, as a file watcher, simply:
- Ensure you have added
kouto-swiss
as a dependency:
$ npm install --save-dev kouto-swiss
- Do an
npm install
- Create a new file watcher with settings like these:
- Create an
@import
in one of you .styl
files:
@import "../../../node_modules/kouto-swiss" // import kuoto-swiss for auto-prefixing (or whatever relative path where node-modules lives
Included in compilation with third-party tools.
To use kouto swiss with third-party tools like Codekit or Prepros, you should include kouto swiss on your project by yourself. You can download it on github.
More information coming soon.
As middleware, for on the fly compilation.
There's an example of how to use stylus with kouto-swiss within Connect or Express.
var connect = require( "connect" ),
stylus = require( "stylus" ),
koutoSwiss = require( "kouto-swiss" ),
server = connect();
function compile( str, path ) {
return stylus( str )
.set( "filename", path )
.set( "compress", true )
.use( koutoSwiss() );
}
server.use( stylus.middleware( {
src: __dirname,
compile: compile
} ) );
Stylus API
To gain access to the kouto swiss tools from your Stylus files, simply add:
@import "kouto-swiss"
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style.
Add unit tests and update the docs for any new or changed functionality.
More informations in the CONTRIBUTING.md
file.
Special call for contribution : someone who's English is better than I am !
I am committed to improving the readability of documents with heart and soul. As you can see, I'm not a native English speaker. I need your help.
If you want to help the kouto swiss project, but don't want to write code, please consider reviewing the docs, correcting my very bad English.
Many thanks!
Release History
- 2014-08-18: version
0.10.0
: some breaking changes in box-sizing mixin. - 2014-07-19: version
0.9.0
: some breaking changes in media-queries management. - 2014-06-30: version
0.8.0
: first stable version of the lib, including website & docs. - 2014-05-20: version
0.1.0
: first version of the lib, including nearly all the basics. - 2014-05-05: version
0.0.1
: first publish on npm, still in early stages of development. - 2014-05-03: starting project
Development TODO
License
Copyright (c) 2014 leny
Licensed under the MIT license.
Licenses for ressources used in docs
Fonts